---
title: Async MongoDB
description: Learn to use MongoDB asynchronously as a database for your Agents
sidebarTitle: Async Mongo
---

Agno supports using [MongoDB](https://www.mongodb.com/) asynchronously, with the `AsyncMongoDb` class.

<Tip>
  **v2 Migration Support**: If you're upgrading from Agno v1, MongoDB is fully supported in the v2 migration script. See the [migration guide](/how-to/v2-migration) for details.
</Tip>

## Usage

```python async_mongodb_for_agent.py
from agno.agent import Agent
from agno.db.mongo import AsyncMongoDb

# MongoDB connection settings
db_url = "mongodb://localhost:27017"

db = AsyncMongoDb(db_url=db_url)

# Setup your Agent with the Database
agent = Agent(db=db)
```

### Run MongoDB

Install [docker desktop](https://docs.docker.com/desktop/install/mac-install/) and run **MongoDB** on port **27017** using:
```bash
docker run -d \
  --name local-mongo \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=mongoadmin \
  -e MONGO_INITDB_ROOT_PASSWORD=secret \
  mongo
```


## Params

<Snippet file="db-async-mongo-params.mdx" />

## Developer Resources

- View [Cookbook](https://github.com/agno-agi/agno/tree/main/cookbook/db/mongo/async_mongodb_for_agent.py)
